WebSentinel Users Guide

Installation

The WebSentinel package includes several different components, each of which belong in a certain place. If you follow this installation guide, you should have WebSentinel up and running in a matter of minutes.
WebSentinel includes both server and client administration software. Both are required in order to use the package, and may be installed on separate machines or directly on your web server. It is recommended that you administer your web server from a separate machine on an AppleTalk network for optimal performance of both the web server and administration client.
Components Overview
With the introduction of WebSentinel 2.0, the installation process has been simplified. There are now only two main files for WebSentinel, the WebSentinel Plug-in and the WebSentinel Admin application. In addition to these two files, you will need at least one Data Target Plug-in, which will allow WebSentinel to interface with the database of your choice. There is a default Built-in Data Target Plug-in that comes with WebSentinel, as well as a special Data Target for those who wish to use Purity Software's Verona database server.

WebSentinel Admin
The WebSentinel Admin application is the primary utility you will use to manage your web site security. It may be run from any machine on the same AppleTalk network as your web server and controls all aspects of WebSentinel.

WebSentinel Plug-In
The WebSTAR-compatible plug-in is what actually does the job of authorizing users for a given area of your web site. It intercepts all requests to the web server and, if there is a realm defined for the given URL, prompts the user to log-in. It also handles the web-based administration interface. The WebSentinel Plug-in resides in the "Plug-ins" folder on your web server.

WebSentinel Data Target Plug-Ins
These shared libraries handle communication between a specific database target and the W*API plug-in or WebSentinel Admin. For example, if you are storing your users and groups data in a Verona database, there is a Verona plug-in that does the job of communicating with Verona; when WebSentinel Admin needs user information, it calls the Verona plug-in which then retrieves the data from Verona and returns it to WebSentinel Admin. These plug-ins are stored in the "Data Targets" folder of the "WebSentinel Data" folder located inside your web server's "Plug-Ins" folder.

Installing the Server Components
The main file that makes up the server software for WebSentinel is the WebSentinel Plug-in, which goes in your web server's Plug-ins folder. You will also need to install the Built-in Data Target Plug-in, which goes inside the Data Targets folder of the WebSentinel Data folder, which is also located in the web server's Plug-ins folder.
Once the WebSentinel 2.0 archive has been downloaded and uncompressed, open the WebSentinel 2.0 folder if it is ot already open. There will be a folder titled "(Put in Server Plug-ins)". Open this folder and drag the contents into your web server's Plug-ins folder. Once you've moved these files over, your web server folder should look close to the following screen shot:

Congratulations, that's all there is to installing WebSentinel. To start using the powerful features that WebSentinel offers, simply restart your web server software.
Installing the Administration Component
The application you will use for much of your administrative needs is called WebSentinel Admin. This application can be copied to any machine on the same AppleTalk network as your web server. If your main workstation is not on the same AppleTalk network as your web server, don't worry -- you can optionally use WebSentinel's web-based administration interface from any web browser on the Internet. You can also use WebSentinel Admin on the same machine as your actual web server, although we don't recommend doing this for any long periods of time, as it will slow down the response time for your server.
To install WebSentinel Admin on a machine other than your web server, such as your personal workstation, simply copy the application to that machine. WebSentinel Admin requires no other files and can be safely put anywhere on the hard drive.
In order to access WebSentinel across an AppleTalk network you must first activate Program Linking in the "Sharing Setup" control panel (if you're running under Mac OS 8, the control panel is named "File Sharing"). If this is your first time using this Macintosh, be sure you have entered a username and password in this same control panel for security! In addition to turning program linking on, you also need to make sure that any users who will need access to the WebSentinel's administration capabilities through WebSentinel Admin have their program linking checkbox checked in the Users & Groups control panel.

If you wish to use WebSentinel Admin on the web server itself, copy it to the web server's hard drive if is not already there.
Congratulations! You've now installed all components necessary to use and administer WebSentinel on your site. For an introduction to WebSentinel's basic features, see the next section, which will guide you through setting up your first protected area, creating users, and logging in to the web site.

[Index] [Prev] [Next]